package cn.tedu.tmall.front.mall.service;

import cn.tedu.tmall.common.consts.data.MallConsts;
import cn.tedu.tmall.common.pojo.authentication.CurrentPrincipal;
import cn.tedu.tmall.common.pojo.vo.PageData;
import cn.tedu.tmall.front.mall.pojo.param.CommentAddNewParam;
import cn.tedu.tmall.front.mall.pojo.vo.CommentListItemVO;
import org.springframework.transaction.annotation.Transactional;

/**
 * 处理评论数据的业务接口
 *
 * @author java@tedu.cn
 * @version 3.0
 */
@Transactional
public interface ICommentService extends MallConsts {

    /**
     * 发表评论
     *
     * @param currentPrincipal   当事人
     * @param commentAddNewParam 新增的评论数据
     */
    void addNew(CurrentPrincipal currentPrincipal, CommentAddNewParam commentAddNewParam);

    /**
     * 查询商品的评论列表，将使用默认的每页记录数
     *
     * @param goodsId 商品ID
     * @param pageNum 页码
     * @return 商品的评论列表
     */
    PageData<CommentListItemVO> list(Long goodsId, Integer pageNum);

    /**
     * 查询商品的评论数据列表
     *
     * @param goodsId  商品ID
     * @param pageNum  页码
     * @param pageSize 每页记录数
     * @return 商品的评论列表
     */
    PageData<CommentListItemVO> list(Long goodsId, Integer pageNum, Integer pageSize);

}
